home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / spitfire / mqm.zip / MQM.DOC < prev    next >
Text File  |  1992-03-30  |  7KB  |  251 lines
  1.  
  2.          ╓───────┐
  3.          ║ ╒╗ ╒╗ │
  4.          ║ │║ │║ │
  5.          ║ │╚═╛║ │  I S T I C
  6.          ║ │   ║ │
  7.          ╚═╛   ╚═╛                                       ┌──────────────────┐
  8.                  ╓──────┐                                │ Written By :     │
  9.                  ║ ╒══╗ │                                │                  │
  10.                  ║ │  ║ │                                │    Mark Gazda    │
  11.                  ║ │  ║ └┐  U E S T I O N A I R R E      │                  │
  12.                  ║ └──╜ ┌┘                               │ On-Line Support: │
  13.                  ╚══════╛                                │   Valhalla BBS   │
  14.                         ╓───────┐                        │  (519) 433-5122  │
  15.                         ║ ╒╗ ╒╗ │                        └──────────────────┘
  16.                         ║ │║ │║ │                            Version 1.0ß
  17.                         ║ │╚═╛║ │  A K E R                Unregistered Relese
  18.                         ║ │   ║ │
  19.                         ╚═╛   ╚═╛
  20.  
  21.  
  22.  
  23.  
  24. MQM.ZIP Should contain:
  25.  
  26.  
  27. MQM.EXE       ════>  Executable file
  28.  
  29. MQM.COL       ════>  Main Display File - ANSI (Do not modify)
  30.  
  31. MQM.NOR       ════>  Main Display File - ASCII (Do not modify)
  32.  
  33. MQM.CFG       ════>  Sample configuration file
  34.  
  35. BUL1.Q        ════╕
  36.                   │
  37. BUL1.NOR          │ 
  38.                   │
  39. BUL1.COL          ├──────>  Sample Questionairre
  40.                   │
  41. BUL1MNU.COL       │
  42.                   │
  43. BUL1MNU.NOR   ════╛
  44.  
  45.  
  46. If any of the files are corrupt or missing, you may download the latest version 
  47. of MQM from Valhalla BBS (519) 433-5122.
  48.  
  49.  
  50. Mistic Questionairre Maker is a utility that allows the SysOp to custom make 
  51. their own questionairres.  The Utility provides support for ANSI, and ASCII, a
  52. defined set of commands, a repeat loop, and an IF statement
  53.  
  54.  
  55. QUICK START
  56.  
  57. For each questionairre you must design a seperate config file.  
  58.  
  59. EG:
  60.  
  61. Valhalla BBS            <  BBS Name
  62. C:\Spitfire            <  Directory where DOOR.SYS is located
  63. 100                     <  Maximum security level of questionairre user.
  64. C:\que\quest1.q        <  Questionairre file
  65.  
  66.  
  67. COMMAND LINE PARAMETERS
  68.  
  69. MQM  <Config filename> [/S /D /R]
  70.  
  71. /S  --  Use for DOOR.SYS & SFDOORS.DAT
  72. /D  --  For DOOR.SYS only.
  73. /R  --  Disable title screen on remote side (registered version only)
  74.  
  75. EG:
  76.  
  77. MQM MQM.CFG /S /R
  78.  
  79.  
  80.  
  81. QUESTIONAIRRE COMMANDS
  82.  
  83. IF <variable>        Compares <variable> to the character last entered, if
  84. END            the character is found in <variable>, MQM executes the 
  85.             following block until the coresponding END is found.
  86.  
  87.  
  88. ELSE_IF <variable>    As above but executes only if previous IF statement
  89. END            was FALSE.
  90.  
  91.  
  92. ELSE            As IF and ELSE_IF, but executes if previous comparison
  93. END            was FALSE.
  94.  
  95.  
  96. DO <number>        Executes block before ENDDO, <number> of times. 
  97. ENDDO
  98.  
  99.  
  100. I: <variable>        Get a character from the remote user with echo to local
  101.             and remote screen.  The character entered must be 
  102.             contained in <variable> or execution will not proceed.
  103.  
  104.  
  105. NEI: <variable>        As with I: but no echo to remote or local screen.
  106.  
  107.  
  108. WI: <file> <variable>    As with I: but writes input to <file>
  109.  
  110.  
  111. WNEI: <file> <variable>    As with NEI: but also writes input to <file>
  112.  
  113.  
  114. O: <string>        Output a 255 character <string> to remote and local
  115.                         screens.  Adds LF and CR.
  116.  
  117.  
  118. L: <string>        As with O: but no LF and CR.
  119.  
  120.  
  121. WS: <file> <string>    As with O: but outputs to the file ONLY.
  122.  
  123.  
  124. S:            Gets a string from the remote user.
  125.  
  126.  
  127. WSS: <file>        As with S:, but writes string to <file> as well.
  128.  
  129.  
  130. B:            Get date from remote user in the format MM/DD/YY
  131.  
  132.  
  133. WB: <file>        As with B: but writes date to <file>
  134.  
  135.  
  136. #:            Get phone number from remote user in the format
  137.             ###-###-####.
  138.  
  139.  
  140. W#: <file>        As with #: but writes to <file>
  141.  
  142.  
  143. D: <ANSI> <ASCII>    Outputs a file to remote and local screens.  Must 
  144.             specify both ANSI and ASCII filenames.  MQM will 
  145.             determine if the user is using ANSI.
  146.  
  147.  
  148. WAITFORKEY        Waits for any key to be pressed before continuing.
  149.  
  150.  
  151. ANSI: <string>        Outputs <string> if user is using ANSI.  <string> can
  152.             contain ANSI escape codes.
  153.  
  154.  
  155. USEC: <number>        Changes user security to <number>
  156.  
  157.  
  158. UTIME: <number>        Adds <number> to users time for this call.
  159.  
  160.  
  161. DOS: <command>        This will execute any DOS command, .COM, .EXE, or .BAT 
  162.             from within the questionairre.  You will return to MQM
  163.             after NORMAL execution.
  164.  
  165.             **Warning**
  166.  
  167.             You may not execute two copies of MQM with this command!
  168.             See QUE: if you wish to do this!  Also if you leave this
  169.             line blank, MQM will drop to dos and suspend execution
  170.             until a user at the LOCAL terminal types in EXIT.
  171.  
  172.             EG:
  173.  
  174.             DOS: FORMAT C:  --  this could prove to be tiring.
  175.  
  176.  
  177. QUE: <questionairre>    Executes another questionairre. Returns to current
  178.             questionairre after completion.
  179.  
  180.  
  181.  
  182. **CAUTION**         If you are executing multiple programs that utilize
  183.             DOOR.SYS or the like, make sure that you copy the 
  184.             correct DOOR.SYS or like file to the appropriate
  185.             directory before copying it back to your main BBS 
  186.             directory.  Failure to do this may result in any changes
  187.             that a program makes to DOOR.SYS to be discarded.
  188.             
  189. -------------------------------------------------------------------------------
  190.  
  191. OUTPUT CODES
  192.  
  193. To be used with L:, O:, WS:
  194.  
  195.     /^  - add a linefeed
  196.     /D  - add DOS date
  197.     /U# - add user phone number
  198.     /UB - add user date of birth
  199.     /T  - add current DOS time
  200.     //  - add a "/" character
  201.     /U  - add the users name
  202.     /US - add the users security
  203.  
  204. EG:
  205.  
  206. O: Hi /U, this is /D, and your birthday is on /UB!!!
  207.  
  208. -------------------------------------------------------------------------------
  209.  
  210.  
  211. History of MQM:
  212.  
  213. 30 March 1992 - decided not to include history of MQM in the Documentation as 
  214.                 it was already too much typing.
  215.  
  216.  
  217.  
  218. There are several other Utilities and Doors available from Valhalla BBS.  In
  219. addition, the authors of this program may be contracted to design custom 
  220. software for your use.  For more information, please contace the staff of 
  221. Valhalla BBS at (519) 433-5122, and leave a comment.
  222.  
  223. DISCLAIMER
  224.  
  225. The authors of this program are not responsible for any damage cause during, 
  226. before or after the execution of this program, and will not be liable for any
  227. damages incured to other software products, hardware, users, or innocent 
  228. bystanders.
  229.  
  230.  
  231. HA. Nuf said!   Had to put that tho!
  232.  
  233.  
  234.  
  235.  
  236.  
  237. Should you have any problems or suggestions, please feel free to contact us at
  238. Valhalla BBS (519) 433-5122.  Have we overdone the BBS number bit yet?
  239.  
  240.  
  241.  
  242. - Matt Duƒresné  & 
  243. - Mark Gazda
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.